###User Defined Function###
_SQLite_Open

###Description###
Opens/creates a SQLite database.

###Syntax###
#include <SQLite.au3>
_SQLite_Open ( [ $sDatabase_Filename = ":memory:" [,$iAccessMode [,$iEncoding ]]] )


###Parameters###
@@ParamTable@@
$sDatabase_Filename
	[optional] Database filename, by default will opens an in memory database.
$iAccessMode
	[optional] access mode flags. Defaults to $SQLITE_OPEN_READWRITE + $SQLITE_OPEN_CREATE  
$iEncoding
	[optional] encoding mode flag, only used at creation time. Defaults to $SQLITE_ENCODING_UTF8
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns database handle.
Failure:	Returns 0.
@error:	-1 - SQLite Reported an Error (Check @extended Value)
     1 - Error Calling SQLite API 'sqlite3_open_v2'
     2 - Error while converting filename to UTF-8
@extended:	value can be compared against $SQLITE_* constants
@@End@@

###Remarks###
There is no need to store the database handle.
Functions that use the handle are using the last opened by default.

To create a database encoded in UFT16 just create it with $iEncoding=$SQLITE_ENCODING_UTF16.

###Related###
_SQLite_Close

###Example###
@@IncludeExample@@